home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / program / gemxx19.zoo / gem++19 / man / gemfs.man < prev    next >
Text File  |  1993-05-04  |  2KB  |  72 lines
  1.                      GEM++ - C++ LIBRARIES FOR GEM/AES/VDI
  2.  
  3.  
  4.  
  5. NAME
  6.      GEMfileselector - high-level file chooser
  7.  
  8. DESCRIPTION
  9.      A GEMfileselector is a source of filenames.  Generally, different
  10.      types of files (eg. Save files; Config files; Font files) should
  11.      each have a different file selector so that the user can leave
  12.      each fileselector in a appropriate directory.  Some types of files
  13.      should NOT have different fileselectors... such as Save files and
  14.      Load files!
  15.  
  16. GLOSSARY
  17.        filename   E:\usr\gem++\foo.bar
  18.        filespec   E:\usr\gem++\*.bar   or   *.bar
  19.        path       E:\usr\gem++\        or   E:\usr\gem++
  20.        file       foo.bar
  21.  
  22.      A "file" appears in the "File:" area of file selector.
  23.      A "filespec" appears in the "Path:" area of the file selector.
  24.      A "filename" is returns by the Get() method.
  25.  
  26. CONSTRUCTORS
  27.      GEMfileselector(int maxlen=128);
  28.      GEMfileselector(char* filename);
  29.  
  30. METHODS
  31.      const char* Get(const char* prompt, char* into=0);
  32.        Prompts user for a filename (using standard fileselector),
  33.        returns copy of chosen filename in "into" if non-0, and returns
  34.        a constant string.  Returns NULL if the user cancels the file
  35.        selection.  The given prompt is used.
  36.  
  37.      AVOID using the following calls.  Each GEMfileselector should remain
  38.      at the path the user specified.
  39.  
  40.      void Path(const char* path)
  41.        eg. Path("E:\\foo"); Path("E:\\foo\\");
  42.  
  43.      const char* File(const char* file=0)
  44.        eg. File("foo.bar"); oldgot=File();
  45.  
  46.      const char* Filespec(const char* filespec=0)
  47.        eg. Filespec("*.bar"); Filespec("E:\\foo\\*.bar"); oldspec=Filespec();
  48.  
  49.      const char* Filename(const char* filename=0)
  50.        eg. Filename("foo.bar"); Filename("E:\\foo\\foo.bar"); old=Filename();
  51.  
  52.      const char* CWD()
  53.        Resets filespec to current work directory.
  54.  
  55. BUGS
  56.      Bugs in GEM++ should be reported to warwick@cs.uq.oz.au
  57.  
  58. AUTHOR
  59.      Warwick Allison, 1993.
  60.      warwick@cs.uq.oz.au
  61.  
  62. COPYING
  63.      This functionality is part of the GEM++ library,
  64.      and is Copyright 1993 by Warwick W. Allison.
  65.  
  66.      GEM++ is free and protected under the GNU Library General Public
  67.      License.
  68.  
  69.      You are free to copy and modify these sources, provided you
  70.      acknowledge the origin by retaining this notice, and adhere to
  71.      the conditions described in the GNU LGPL.
  72.